Appendix E: ASCII Waveform Export 




Using ASCII-Stored Files 

The ASCII waveform storage feature allows waveforms to be 
stored to a mass-memory device in any of three ASCII 
formats: Spreadsheet, Mathcad and MATLAB. Each format is 
tailored for a commonly used analysis package. The user- 
interface changes supporting ASCII waveform storage are 
found in the STORE menu (see Chapter 13). 

The table below summarizes the three formats’ basic layout. 
Examples of the use of each format are given on the following 
pages. 



Format 


Header 

Format 

includes some 
form of 
header before 
the data 


Time 

Values 

Format stores 
time values 
with each 
amplitude 
value 


Amplitude 

Values 

Format stores 
amplitude 
values 


Sequence 

Times 

Fleader 
contains 
sequence time 
information for 
each sequence 
segment 


Multi- 

Segment 

Format 
concatenates 
multiple 
segments of a 
sequence 
waveform 


Dual Array 

Format allows 
dual-array 
data (i.e. 
Extrema, or 
complex FFT) 
to be stored 


Spreadsheet 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


Mathcad 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


MATLAB 


No 


No 


Yes 


No 


Yes 


No 
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Using the Spreadsheet Format with Excel 



This example was created using Microsoft Excel, Version 7.0 
for Windows. A waveform stored in Spreadsheet format may be 
read into Microsoft Excel using the File -> Open dialog as 
follows: 




Excel will now ask for more information about the file type. Ensure 
that the ‘Delimited’ option is selected in the first step of the Wizard. 
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Text Import Wizard - Step 1 of 3 



The Text Wizard has determined that your data is Delimited. 

If this is correct, choose Next, or choose the Data Type that best describes your data. 



Original Data Type 

Choose the file type that best describes your data: 

(5 j Delimited ; - Characters such as commas or tabs separate each field (Excel 4.0 standard). 

O Fixed Width - Fields are aligned in columns with spaces between each field. 



Start Import at Row: fl ^ File Origin: (Windows (ANSI) [±] 



Preview of file A:\lecroy_1.dir\SC1003.txt. 



1 


LECROY93S4L, 935400000 


♦ 


2 


Segments, 1 , SegmentSize, 25002 




3 


Segment , TrigTime, TimeSinceSegment 1 




4 


#1, 02-Apr-2030 11:33:50,0 




5 


Time, Ampl 




6 


-5e-Q6 .-Q.Q296875 


♦ 




111 





Cancel | 


| Next > | Finish 









The next step allows the specific delimiter to be specified. The 
Spreadsheet format generated by the scope uses a comma (,) to 
delimit columns. Ensure that this is selected. 




■ 
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The third and final step allows the format of the columns to be 
specified. The ‘general’ format for each column should be used 
(this is the default). 




After clicking the Finish button, a display similar to that following 
should be displayed. 
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-| Microsoft Excel - SCI 001 .TXT j^H 


1 =■ File Edit View insert Format lools Data 




A IH1 B ■ 


C 


D 


|i| 


LECROY9354L 935400000 






2 


Segments 1 


SegmentSize 


502 


3 


Segment TrigTime 


TimeSinceSegmentl 




4 


#1 22.03.30 20:22 


0 




5 


Time Ampl 






6 


-5.01 E-05 -0.00755 






7 j 


-4.99E-05 -0.00755 






8 


-4. 97 E-05 -0.00755 






9 


-4. 95 E-05 -0 00755 
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Plotting a Single- Plotting the data from a single-segment waveform requires the use 

Segment Waveform of a scatter plot based on the data in the first two columns with the 

first column used as the X values. 



Extracting Segments 
from Sequence 
Waveforms 



The header created for the Spreadsheet format contains all the 
information required to extract various elements of a sequence 
waveform. The following Formulae may be used to extract 
information such as the start and end row of the data for a given 
segment, or the trigger time of a given segment. 



SegmentStartRow := ( DesiredSegment * D2) + B2 + 5 
SegmentEndRow := SegmentStartRow + D2 -1 



TrigTime= IN D I RECT ( A D D R E SS ( DesiredSegment +3 ;2 ;4)) 

TimeSinceFirstTrig= INDIRECT (ADDRESS (DesiredSegment 

+3;3;4)) 

Plotting the data from all segments using a scatter plot will result in 
all segments overlaid (similar to the scope’s display of sequence 
traces in persistence mode). 
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Using Mathcad 



These examples were created using MathSoft’s Mathcad for 
Windows. On this and the next page, the procedure for reading 
and graphing a file for a single segment is shown, using 
Mathcad Versions 3.1 and 7, respectively. The example on page 
E-9 is for multiple segments. 

Single-Segment, Version 3.1 This single-segment example illustrates the use of Mathcad Version 

3.1: 



a :=READPRN(scl004) 
n:=2.. (1 + Yj) 

. <o> 

time .= a 



Read data from file sc1004.prn into matrix 'a' 
Create ramp over all rows containing data 

Extract time vector 



ampl .= a 



iff v'-t ■— t *v. I it i i r4 <.tr> 



■ I L 



cctor 
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Single-Segment, Version 7 This single-segment example is valid for more recent versions of 

Mathcad: 



A = READPRN[ file) 

K last A <0> ) 

A : = submatrix( A , 2, K, 0, 1 ) 

t = A <0> v =A <1;> K : = last(t) k =0..K 1 



l 




_ j l l l l l l 

-0.001 0 0.001 0.002 0.003 0.004 
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Multi-Segment Example 



The following Mathcadexample demonstrates how to extract data 
from a given segment. The data used for this example consisted of 
two segments of three samples each, allowing the entire imported 
matrix to be shown. 



Read data from file 

a :=RJEADPRN(sclOOO) 

Extracting the first segment only (or only segment if not sequence trace) 

n:= { 1 + Yo}"{yo + Yi} n 

m:=0. 1 3 

&stse ^-i-Y 0 *=\* j 

T T 

firstseg = 1.1 2 

,1.2 3, 

Extracting a given segment 

numsegments := ^ 0 Total number of segments in trace 

segten -y, Number of samples in each segment 

segment :=0 Desired segment number 



2 3 

1 0 
2 999 

1 1 
a = U 2 
1.2 3 
1 1.1 
1.1 2.1 
1.2 3.1 



segstait := 1 + numsegments + segment seglen Index of first point in segment 

segend :=segstart+ seglen - 1 Index of last point in segment 



segtime := a 



seiner! + 1 ,1 



Segment trigger time 



<o> 

x .= a 

. <i> 

y .= a 

i := segstart.. segend 
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Using MATLAB 



This example was created using MathWorks’ MATLAB Version 
4.2c.1 for Windows. 

Reading and graphing a waveform in MATLABmay be achieved with 
two simple commands, as the following example shows. The first 
command loads the file into a matrix which is automatically named 
after the file. The second command plots this matrix. 



MATLAB Command Window 



File Edit Options Windows Help 



Commands to get started: intro, demo, help help 

Commands for more information: help, whatsneu, info, subscribe 



» load a:\lecroy_1.dir\sc10O0.dat 
» plot(sclOOO) 
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Detailed Description of the Formats 



Spreadsheet Format 



Note: Fields in bold type are constants that are present in 
the output file as shown. Fields in italic are variables that are 
filled in when the file is written. 



<scopeid>, <scopeserial> 

Segments, <numseg>, SegmentSize, 

<numpts> 

Segment, TrigTime, 

TimeSinceFirstSegment 

# 1 , <trigtime(1)>, 0.0 

#<numseg>, <trigtim e(numseg)>, 

<\ng6e\\a(numseg)> 

Time, Ampl, [Ampll] 

m, y(0), [yi(0)] 

x(i), y(V, [y 2 ( 0 )i 

x(numgseg*numpts ), y(numseg*numpts), 

[yl (numseg*numpts)] 



Single-Segment Example 

LECROY9354, 935412345 
Segments, 1, SegmentSize, 502 
Segment, Trig Time, TimeSinceFirstSegment 
#1,21 Mar 1990 9:37:08,0.0 
Time, Ampl 
0 . 0,1 
0 . 1,2 
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Multi-Segment Example 

LECROY9354, 935412345 
Segments, 3, SegmentSize, 502 
Segment, Trig Time, TimeSinceFirstSegment 
#1,21 Mar 1990 9:37:08,0.0 
#2,21 Mar 1990 9:37:13,5.0 
#3,21 Mar 1990 9:37:15,7.0 
Time, Ampl 
0 . 0,1 
0 . 1,2 

0 . 0 , 1.1 
0 . 0 , 2.1 

0.0,1.05 

0.0,2.05 



Dual-Array Example 

LECROY9354 , 935412345 
Segments, 1, SegmentSize, 502 
Segment, Trig Time, TimeSinceFirstSegment 
#1,21 Mar 1990 9:37:08,0.0 
Time, Ampl 
0 . 0 , 1 . 1 , 1.1 
0 . 1 , 2 . 1 , 2 . 1 



Note: 

> The basic structure of the Spreadsheet format is a 
header containing scope identification information, 
followed by a block containing trigger times for multi- 
segment waveforms, followed by the data itself. 

> This format is compatible with the ASCII import of the 
LeCroy LW4xx Arbitrary Function Generator. 
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Mathcad 



Format 

<“scopeid”> 

<“TriggerTime”> 

<numseg> 

Segment 

1 



<numpts> 

TimeSinceFirstSegment 

0.0 



<numseg> 

Time 

<x(0)> 

<x(1)> 



ctrigdelta {numseg)> 

Ampl Ampll 

<y(0)> [<yi(0)>] 

<y(1)> [<y1(1)>] 



<x(numgseg*numpts)> <y(numseg*numpts)> 
[<y1 (numseg*numpts)>] 



Single-Segment Example 

"LECROY9354, 935412345" 
”23-March-90, 12:44 : 23" 



1 


502 


Segment 


TimeSinceFirstSegment 


1 


0.0 


Time 


Ampl 


0.0 


1 


0.1 


2 
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Multi-Segment Example 



"LECROY9354, 


935412345" 


”23-March-90 


, 12:44:23" 


3 


502 


Segment 


TimeS inceFir st Segment 


1 


0.0 


2 


5.0 


3 


7.0 


Time 


Ampl 


o 

o 


1 


0.1 


2 


0.0 


1 . 1 


0.1 


2 . 1 


0.0 


1.05 


0.1 


2.05 



Note: 

| > The format created for MathCad is very similar to the 

Spreadsheet format, but with some differences due to the 
way MathCad interprets the header information. 

| > One of the most important of these is that the absolute 

trigger time is only given for the first segment, with relative 
times (in units of seconds) being included for each segment. 

| > Another difference is that the scope identification and trigger 
time are wrapped in quotes to ensure that MathCad does not 
attempt to import them. 
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MATLAB Files 



Format 

y(0) 

y(i) 

y(numseg*numpts) 

Single Segment Example 

1.0 

1 . i 
1.2 

4.5 



Notes 

> The MA TLAB format is simple, without header information and having 
amplitude values only. 

> Multiple segments will be appended without a separator. 

> Only one value from the pair of amplitude values present in a dual-array 
will be stored. 
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